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Field Name 


Data 
Type 


Description 


Common fields 


sName 


string 


A unique identifier for the quantity. This is the name that the 
student sees, and is also the name used within algorithms to 
access the quantity values in a scenario. Quantity identifiers 
are case-insensitive, and any two sequences of whitespace 
characters are always considered equivalent. 


blnstrument 


boolean 


If FALSE, indicates that the quantity is an outcome quantity. If 
TRUE, indicates that the instrument is either an instrument 
quantity or an exiernai quantity \uescriDea idierj. 


sDefinition 


string 


Provides a brief textual description of the quantity, available to 
the student. Format is HTML, so that text formatting and links 
to related information can be embedded. All quantities should 
observe a similar style and voice in this field. 


sUnit 


string 


A standardized text description of what kind of number value 
the quantity holds. Examples include "1 kilogram", "percent", 
"years", or "$1 Billion". 


dPIaceholder 


floating 
point 


The default initial value for the quantity, that is, for period 0. 


sNewsFn 


string 


Optional. C code that can generate a qualitative description of 
a change in the state of the model (described later). 


LineColor 


integer 


An RGB color value. This color is used as the line color 
whenever the quantity appears in any QuantitiesGroup 
window. It may also be used as the text color whenever the 
quantity name appears as a hyperlink anywhere in the 
learning environment. 
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Field Name 


Data 
Type 


Description 


Outcome-specific fields 


sNextValueFn 


string 


C code that implements the outcome quantity's value- 
computation algorithm. Assumes the result will be placed in 
the predefined floating-point variable dQResult. 


sNextValueDescr 


string 


Provides a brief textual description of the value-computation 
algorithm. Format is HTML, so that text formatting and links to 
related information can be embedded. All quantities should 
observe a similar style and voice in this field. 


sExplainNVFn 


string 


Optional. Provides a longer, more detailed textual description 
of the value-computation algorithm. Format is HTML. 
Generally speaking, the more lines of code in sNextValueFn, 
the more highly recommended it is to use this field. 


Instrument-specific fields 


bExternal 


boolean 


If TRUE, indicates that the quantity is an external quantity 
(described later) in all scenarios. If blnstrument is FALSE, this 
field is ignored. 


sBoundsViolFn 


string 


C code that checks to ensure that a new instrument value is 
"legal" for the domain model. If the new value is out of 
bounds, whether too high or too low, the simulation may not 
be executed until the value is modified. 


nFunctionaries 


integer 


The number of automated agents that have been defined for 
this instrument. 


FunctionaryFns 


array of 
strings 


The C code implementing the algorithm for each of the defined 
agents. Assumes the result in each will be placed in the 
predefined floating-point variable dQResult. Each array 
element corresponds to one agent, and the array size is 
always equal to nFunctionaries. 


F u nctio na ry Strateg ies 


array of 
strings 


Provides a brief textual description of the value-setting 
strategy for each of the defined agents. Should observe a 
similar style and voice in this field for all agents. Note that, 
depending upon pedagogical considerations, additional 
information or additional fields could be defined for each 
agent. For example, if each agent should have an associated 
picture, a field could be added for picture filenames. 


InitDefaultFarylndex 


integer 


Indicates which of the automated agents will be in effect 
initially when the scenario begins. If the quantity is an 
external, the indicated agent will control the value selection 
throughout the entire scenario. 
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Field Name 


Outcome Quantity Example 


sName 


"Unemployment Rate" 


blnstrument 


FALSE 


sDefinition 


I he unemployment Kate is tne percentage ot tne wonvrorce inai aoes not nave gainiui 
employment at a point in time. The workforce only includes persons who are willing and able to 
work. 

$$$typical begin### 

The unemployment rate can range from 2 percent to 30 percent. Higher rates are likely to lead 
to social breakdown. 
$$$typical end### 

$$$model Inflation and Unemployments" 


sUnit 


0.01 


dPIaceholder 


5.0 


sNewsFn 


double dNatural = Value( "Natural Unemployment Rate" , -1 ); 
double dExcess = dNewValue - dNatural; 




if ( ( dExcess > 2.0 ) && (dExcess < 8.0) ) 
{ 

CString s; s.Format( "$$$def Your advisor###: Unemployment rate of %.1f is worrisome", 
dNewValue ); 
AddNews( sQName, 

s, 

10, // importance, scale 0-100 (default value is 1 .0) 

2 // "can repeat after" (must wait 3 quarters before repeating) 

); 








} 

if ( dExcess >= 8.0 ) 

f 
i 

double dlmportance = 50; 
Add News ( sQName, 

"$$$def National Times###: Citizens desperate for relief from severe unemployment 
problem", 
dlmportance, 
0 

); 

> 




LineColor 


(24 24 24) 


sNextValueFn 


double dReal = Value( "Real Output", -1 ); 
double dPotential = Value( "Potential Output", -1 ); 
double dRatio = dReal / dPotential; 

double dNatural = Value( "Natural Unemployment Rate", -1 ); 
double dLastUnem - vaiue( unemployment Kate , -i ), 
double dTarget; 

if ( dRatio <= 1 .0 ) // under capacity 

HTarnot — H Natural + Mflfl fl * M n . HRatin^ V 
u i argei — uiNaiurai f \ \ uu.u \ \ .u - ur\auu^ ), 

else 

dTarget = dNatural * ( 1 .0 / pow( dRatio, 10.0) ); 
dQResult = dLastUnem + ( 0.75 * ( dTarget - dLastUnem ) ); 


sNextValueDescr 


"Computed as a function of the difference between $$$qty Real Output### and $$$qty 
Potential Output###. Unemployment is high when actual real output is less than potential, and 
the unemployment rate is low when actual is higher than potential. Greater differences 
between the two cause larger effects on unemployment." 


sExplainNVFn 


"Changes in unemployment result when there is a mismatch between output and the capacity 

of..." 
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Fi Id Name 


Instrum nt Quantity Example 


sName 


"Defense Expenditures" 


blnstrument 


TRUE 


sDefinition 


"Defense Expenditures is the total amount spent for our military, including 
salaries, equipment, weaponry, and other expenses. 

$$$typicat begin### 

Defense expenditures may be zero, or may soar above 10 percent of $$$def 
total output|total output### during wartime. 
$$$typical end###" 


sUnit 


$1 Billion 


dPIaceholder 


100 ( 


sNewsFn 


double lastAmount = Value( "Defense Expenditures", -1 ); 
double pctg = PercentChange( lastAmount, dNewValue ); 

if ( pctg > 10.0) 
{ 

AddNews( sQName, 

"$$$def National Times###: $$$qty Defense Expend itures### increase 
dramatically ", 

LinearEffect( pctg, 5.0, 20.0, 10, 40 ), 

1); 

} 


LineColor 


(0 0 140) 


bExternal 


FALSE I 


sBoundsViolFn 


if ( dProposedNewValue < 0.0 ) 
{ 

bTooLow = TRUE; 
dValueLimit = 0.0; 

sExplanation = "Defense Expenditures cannot be negative."; 

else if ( dProposedNewValue > Value( "Current Output", -1 ) ) 
{ 

bTooHigh = TRUE; 

dValueLimit = Value( "Current Output", -1 ); 

sExplanation = "Defense Expenditures cannot possibly be greater than total 
output."; 
} 


nFunctionaries 


2 


FunctionaryFns 


Automated Agent 1: 

double dLowerLimit = Average( "Current Output", -4, -1) * 0.02; 

dQResult = max( dLowerLimit, Value( Defense Expenditures , - 1 ; u.yo ), 

Automated Agent 2: 

double dUpperLimit = Average( "Current Output", -4, -1 ) * 0.1 0; 

double dGrowthFactor = ( Value( "Price Index", -1) / Value( "Price Index", -2 
) ) * ( Vaiue( "Potential Output", -1 ) / Value( "Potential Output", -2 ) ); 

dUKesult — min( oupperLirrni, vaiue^ ueiense txpenaiiures ,-i ; nidA^ 
1.02, dGrowthFactor)); 


FunctionaryStrategies 


Automated Agent 1: 

"We need to reduce our heavy spending on military expenditures so that we 
can focus our economy's resources more on the private sector. Advances in 
military technology have made it possible for us to do more with less." 

Automated Agent 2: 

"We need to build up our defense capabilities. It's an increasingly 
dangerous world out there, and our weapons systems are getting old." 


InitDefaultFarylndex 


0 
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"Mticfarlcine TaxLuts" - Scenario Introduction 



UK- 



The Macfarlane Tax Cuts 

It is the year 2017, and the public and politicians alike are alarmed at the recent 
surge in unemployment. Unemployment has been low for the past decade, but it has 
recently shot up above 9 percent. 



The Democrats are loudly denouncing the president almost every 
day. Republican Carl Macfarlane won the 2016 election on a tax- 
reduction campaign platform, and, once elected, he immediately 
pushed dramatic tax decreases into place. In the first year, the 
General Tax Rate has dropped from 26 percent of Cjlimd OMtptH 
down to 18 percent; individual tax rates dropped significantly, and 
the Corporate Tax Rate has dropped from 40 percent down to about 20 percent. 

To attack the unemployment problem, Congress is putting together a "stimulus" 
program which will significantly increase discretionary spending during the next two 
years. They argue that the increased spending will create jobs and stimulate 

investment 

Many economists, however, point to the chronically high rates of inflation that the 
country has been experiencing, and they warn that adding new spending on top of 
Macferlane's dramatic tax cuts will "overstimulate" the economy and trigger even 
worse inflation. They suggest that the effects of the tax cut will only occur with a lafl, 
and that the recent unemployment is likely to reverse itself any day now. 




574 -Corporate Profits 



1$ 16 16 16 1? 
91 fl2 Jfl <r1 31 



Meanwhile, the corporate tax cuts are already 
having big, positive effects on the level of 
123 -Ayg imemst Rate Corporate Profits . Recent earnings reports 
from corporations have been spectacular, and 
stock prices are rising. Some business leaders 
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